Node / meshtastic / Meshtastic-Android / files / specs / 20260711-153545-message-markdown-styling / data-model.md

Displaying Rendered • View raw • Download

No persisted entities, no database migration, no protobuf changes. Markdown is parsed at render time and styled at display time; nothing is stored. This document defines only the in-memory types the parser and renderer pass around.

• Raw text — the exact bytes the user typed / that arrived on the mesh, delimiters included (T383838"a **b** c"). This is what T383838TextFieldState.text holds and what T383838sendMessage transmits.

• Display text — delimiters stripped, mentions substituted to display names (T383838"a b c"). All spans are expressed in display-space offsets.

• The parser is responsible for producing the display string and the spans in one pass so offsets are internally consistent (research R3).

The five inline styles, parity with iOS T383838MarkdownStyle.

│ T383838Code │ BT383838 │ T383838FontFamily.Monospace │

│ T383838Link │ T383838LINK0 │ T383838LinkAnnotation.Url (styled + tappable) │

└───────────────┴──────────────┴────────────────────────────────────────┘

An inline style applied over a display-space range.

• T383838range: IntRange — half-open in practice (T383838start until end), display-space.

• T383838style: InlineStyle — one of the non-link styles (T383838Bold/T383838Italic/T383838Strikethrough/T383838Code). Multiple T383838StyleSpans may overlap (e.g. bold+italic).

A markdown link over a display-space range.

• T383838range: IntRange — covers the link's display text (the label), display-space.

• T383838url: String — the resolved destination.

The parser's return value — the single source of truth for a render.

• T383838displayText: String — delimiter-stripped text (mentions already substituted by the caller before parsing, per R3).

• T383838styleSpans: List<StyleSpan>

• T383838linkSpans: List<LinkSpan>

│ The renderer (T383838AutoLinkText) consumes T383838InlineMarkdownResult, then layers mention

│ T383838LinkAnnotation.Clickable spans and URL/email/phone autolink spans over the same T383838displayText,

│ using T383838usedIndices to prevent overlap with markdown links.

Return of each pure formatting helper (parity with iOS T383838FormattingResult).

• T383838text: String — new raw text after the edit.

• T383838selection: TextRange — new selection to apply to the T383838TextFieldState. T383838TextRange is a Compose Multiplatform T383838commonMain value type (no Android/desktop platform dependency); the helpers therefore stay T383838commonTest-runnable. A plain T383838IntRange/T383838Int pair is an acceptable framework-free substitute if preferred.

No other state is introduced. Toolbar visibility (T383838focus && text.length >= 3), the link-dialog URL string, and the pending link range are ordinary composable T383838remember/state, not model entities.

• No new column on the message entity, no T383838messagePayloadMarkdown-style stored/derived field (Android parses at render time, unlike iOS which persists a derived autolinked payload). Confirmed against T383838feature/messaging + T383838core/database.

• No protobuf field; wire payload = raw T383838TextFieldState.text.

• No new Room migration.